FM Towns: Free Software Collection 11

home *** CD-ROM | disk | FTP | other *** search

/ FM Towns: Free Software Collection 11 / FM Towns Free Software Collection 11.iso / t_os / lib / objcol2 / objcol2.doc < prev next >

Wrap

Text File | 1995-08-13 | 19.1 KB | 582 lines

　　／　　　　　　　　　　　　　　　　　_ 　／－－－－－－－－－－－－－－－－－－－_ ／　オブジェクトコレクション２ for GCC 　　_ _　　　　　　　　　　　　　　　　　　　　　／　_－－－－－－－－－－－－－－－－－－－／　　_ by SAKU ／ Chapt.1 ご挨拶あーっ。あーっ。本日は晴天なり。テス、テス。只今マイクのテスト中。．．．マイクおっけー。じゃー、フリコレ１１用のご挨拶から始めましょうかー。．．．あれ、みんなどうしたの。．．．えっ、もう始まっているって！　（気を取り直して）どうも、今日は。わたしが、皆様をご案内するSAKUといいます。今回のフリコレ１１には、簡易修飾印刷プログラム「源二郎」とこの「オブジェクトコレクション２」を応募しました。ここでは、「オブジェクトコレクション２」について、使用方法、注意などをゲストの方々とともに解説していきたいと思います。 Chapt.2 ゲスト紹介　それではゲストを紹介します。ますはじめに、Ｕさんです。趣味は、薬の合成、テレビ鑑賞だそうです。ちょっとおせっかいで、よく、問題をおこします。ちょっとタカピーで、失礼な事を言うこともあるでしょうが、おおめに見てやってください。　次に、Ｂさん。趣味は、お茶を飲むことだそうです。今回の３人のゲストのなかでは最もバランスのとれた方です。この方が、いろんな問題を解決してくれるでしょう。　最後にＳさん。趣味は、機械等の製作で、ハードとソフトどちらもこなす素晴らしい方です。しかし、ちょっとわがままで子供っぽいので、頼りないですね。　以上で、ゲストの紹介を終わります。．．．ゴゴゴゴッ、ドカーン（雷の音、爆発音）．．．Ｕ）　あれ、司会者のSAKUが倒れちゃったよ。なにか悪い持病でも持ってた　　のかな。それじゃ、これからはわたしが仕切って、解説を進めていくわ　　よ。おーっほほほ。 Chapt.3 概略Ｕ）　今回の「オブジェクトコレクション２」には、７つのオブジェクトが　　収録されているのよ。なんか私だけしゃべってたんじゃ悪いから、Ｓに　　少ししゃべらせてあげるわ。ほら、Ｓ、７つのオブジェクトの簡単な説　　明をしなさい。Ｓ）　なによ、Ｕ、勝手に仕切っちゃて。本当は、よくわからないから、私　　に振ったんでしょ。まあいいわ。ここは、機械の事なら何でも任せての　　天才Ｓさまがびしっと決めてあげるわ。　　┌─────┬───────────────┬────┐ 　　│ファイル名│主な機能　　　　　　　　　　　│ Chapt. │ 　　├─────┼───────────────┼────┤ 　　│button　　│ボタンの制御、管理　　　　　　│　　４　│ 　　│filesel 　│ファイルの選択　　　　　　　　│　　５　│ 　　│sort　　　│整数、文字列配列の順位を調べる│　　６　│ 　　│strin 　　│文字列入力　　　　　　　　　　│　　７　│ 　　│symbol　　│文字列出力　　　　　　　　　　│　　８　│ 　　│value 　　│文字列の数値化　　　　　　　　│　　９　│ 　　│vircon　　│仮想コンソール画面　　　　　　│　１０　│ 　　└─────┴───────────────┴────┘ 　　　簡単な表にするとこんなもんね。これでどうかしら、お姉さま。Ｂ）　ええ、素晴らしい出来だわ。Ｓ）　そうでしょ。Ｕ）　なにいってんのよ。こんなに簡単な説明じゃ、全然わからないじゃな　　い。Ｂ、あんまりＳを調子に乗せないでよ。Ｓ）　Ｕこそなにバカなこといってんのよ。詳しくはあとで別々に解説する　　から、今はこれくらいでちょうどいいのよ。これだから素人は困るのよ。Ｕ）　私はそんな口をきく妹に育てた覚えはないよ。Ｓ）　私はＵに育てられた覚えはないわよ。．．．ゴゴゴゴッ、ドカーン（落雷と爆発の音）．．．Ｂ）　それでは、次にいきましょうか。 Chapt.4 button についてＵ）　ゲホゲホ．．．えーっ、これの主な機能は、読んで字の如く「フトン」　　が少し変化して「ブットン」と読み、あなたの察するとおり、フトンが　　より寝やすく改良された物で、現在実用特許登録申請中．．．Ｂ）　Ｕ、うそはいけませんよ。そんな事言って、これを見ている人が勘違　　いをしたら大変でしょ。Ｕ）　ごめん、ごめん。つい。そうだ。Ｂ、あんたまだあんまりしゃべって　　ないんだからここの解説をしなさいよ。Ｂ）　ええ、それではこの章は、わたしが解説いたします。【機能　】簡単なボタンの制御をする。（１６色）【ソース】button.c 【ヘッダ】button.h 【関数　】 ○ BT_init( char *egbwork ) Ｂ）　この関数は、ボタン制御に関する初期化をするもので、他のボタン制　　御関数を呼び出す前に、実行する必要があります。・引数　char *egbwork: EGB-BIOSワークエリアのポインタ・戻値　なし ○ BT_create( int type, int bx, int by, int dx, int dy, char *mes ) Ｂ）　この関数では、ボタンを製作して、そのボタン番号を返します。この　　ボタン番号は、ボタン制御において必須なので、きちんと変数に格納し　　てください。それと、作れるボタンは１６個までなので、いらなくなっ　　たボタンは、 BT_disappear 関数で、消去してください。・引数　int type : ボタンの表示(非表示:0 表示:1) 　　　　int bx,by: ボタンの左上の座標　　　　int dx,dy: ボタンの大きさ　　　　char *mes: ボタンに表示する文字列(NULLのときは無地のボタン) ・戻値　0-15: 作ったボタンのボタン番号[※重要] -1 : ボタンが16個以上作られている。 ○ BT_getStatus( int num, int *state ) Ｂ）　ボタン番号 num のボタンの表示状態を state に返します。・引数　int num : ボタン番号　　　　int *state: 表示状態を格納する変数のポインタ・戻値　 0 : 正常終了 not 0: ボタン番号 num のボタンは存在しない。 ○ BT_reverse( int num, int in ) Ｂ）　ボタン番号 num のボタンの表示状態を変更します。・引数　int num : ボタン番号　　　　int in : 表示状態の変更方法　　　　　　　　　(0:通常 1:反転 2:現在の状態と逆にする) ・戻値　 0 : 正常終了 not 0: ボタン番号 num のボタンは存在しない。 ○ BT_disappear( int num ) Ｂ）　ボタン番号 num のボタンを削除します。削除しても、グラフィック画　　面を復元しませんので、お手数を掛けますが、ユーザーが各自、処理し　　てください。・引数　int num : ボタン番号・戻値　 0 : 正常終了 not 0: ボタン番号 num のボタンは存在しない。 ○ BT_check( int num, int cx, int cy ) Ｂ）　マウスカーソルがボタン番号 num のボタンの範囲に有るかどうかを　　調べます。・引数　int num : ボタン番号　　　　int cx,cy : マウスカーソルの位置・戻値　BTC_ON : マウスカーソルはボタンの範囲内にある。　　　　BTC_OFF: マウスカーソルはボタンの範囲内にない。 1 : ボタン番号 num のボタンは存在しない。【補足　】Ｕ）　Ｂ、ごくろうさま。それじゃ、わたしがちょっと補足を。　　　まだ、ボタンの文字色や背景色などが変更できなかったり、グラフィッ　　クの退避をしていなかったりで、見栄えが単調で見た目が情けないけど、　　取り合えず［源二郎］にこのオブジェクトを使ってるんで、応募したん　　だってっさ。まあ、おおめに見てやってよ。　　　それと、これをリンクするときは、symbol.o も一緒にリンクするんだ　　よ。内部でこのオブジェクトの関数を使ってるからね。Ｂ）　１６色専用って事も覚えておいてくださいね。 Chapt.5 filesel についてＵ）　それじゃ、次はわたし．．．Ｓ）　わたし、わたし、わたしーっ。つぎはわたしが解説するのよ。Ｕ）　なにいってんのよ。あんたはChapt.3をやらせてあげたでしょ。Ｓ）　いやいやいや。わたしがやるったらやるんだもん。Ｕ）　あんた、さっきのケンカで、顔が汚れてるわよ。そんな顔で解説して　　あんたの格が落ちてもしらないわよ。Ｓ）　えーっ。そんなー。（Ｓ、鏡の前へダッシュ。）Ｕ）　ふっ、勝ったわ。それじゃここはわたしが解説するわよ。そこのディ　　スプレイの前のあんた。ありがたく、正座してお読み！【機能　】ＧＵＩによるファイル名取得をする。（１６色）【ソース】filesel.c fsdat.c 【ヘッダ】filesel.h 【関数　】 ○ FS_fileSelect( char *egbwork, char *wild, char *path ) Ｕ）　この関数で、ファイル名を取得することができるのよ。ファイルセレ　　クタの位置を変えたきゃ、この関数を実行する前に FS_locate 関数で　　位置を指定するのよ。　　　あと、ワイルドカードだけど、例えば"*.*"や"*.exp"のようにするん　　だよ。"/*.*"や"\bin\*.exe"のようにはしちゃだめだよ。　　　path は、十分なサイズを用意しないと、とんでもないことが起きる　　かもよ。　　　それと、ユーザーが右クリックをすると、関数が異常終了するから、　　そのへんも考えに入れてプログラムするんだよ。・引数　char *egbwork: EGB-BIOSワークエリアのポインタ　　　　char *wild : ワイルドカードの文字列　　　　char *path : ファイル名を格納する文字列・戻値　0: 正常終了　　　　1: 右クリックによる入力拒否 ○ FS_locate( int x, int y ) Ｕ）　これはファイルセレクタの位置を変える関数で、きちんと範囲内に指　　定しないと、おこるわよ。・引数　int x,y: ファイルセレクタのグラフィックの左上の座標 ( 0 <= x <= 511, 0 <= y <= 263 ) ・戻値　0: 正常終了　　　　1: 座標指定が適切な範囲内にない【補足　】Ｕ）　これは、なかなか使えるプログラムだと思うよ。Ｂ）　そうですね。前回もこのファイルセレクタは応募したけど、フロッピ　　ーが入ってない状態でＡドライブやＢドライブにアクセスすると、止まっ　　てしまいましたからね。でも今回のは、ドライブにフロッピーが入って　　なくても、きちんとスキップして、つぎのドライブをアクセスしにいき　　ますから、ちょっと待たされますけど、止まることはなくなりました。Ｕ）　あれーっ。でも、ＣＤ－ＲＯＭドライブが読めないし、ＤＯＳフォー　　マットでないフロッピーを入れて読みにいくと、止まっちゃうよ。Ｂ）　それは、ＤＯＳの int 25H をディスクのチェックに使っているからな　　なんですが、対応策は今のところないそうです。ごめんなさい。　　　あと、これをリンクするとき一緒に symbol.o もリンクしてください。Ｕ）　これも１６色専用だってさ。 Chapt.6 sort についてＳ）　次は、わたしが解説をするわよぉ。いいわね、Ｕ。いいですよね、お　　姉さま。Ｂ）　ええ。いいですよ。Ｕ）　（．．．くっ。この生意気娘が。）まあいいわ。それじゃ、わたした　　ちは、「みんなのＴｅａＲｏｏｍ」で、お茶でも飲んでいようかね、Ｂ。Ｂ）　そうですね。ここはＳにまかせて、そうしましょうか。Ｓ）　ええっ。お姉さまもいっちゃうの。Ｕ）　なによ、やっぱり一人じゃ何もできないので。まだまだ子供ね。Ｓ）　（ムカッ。）フン、わたしひとりでできるもん。Ｕなんか、もう戻っ　　てこなくていいわよ。Ｕ）　それじゃいこうか、Ｂ。Ｂ）　ええ。それじゃＳ、がんばってね。Ｓ）　それじゃ、はじめるわよ。【機能　】整数、文字列の配列のソート順を出力する。配列を書き換えるこ　　　　とはしない。【ソース】sort.c 【ヘッダ】sort.h 【関数　】 ○ sort( int sorttype, int argtype, void *data, int n, int *retlank ) Ｓ）　このオブジェクトにはこの関数しかないわよ。まあ、それも当然だけ　　どね。文字列の時は、ポインタのポインタを渡すのよ。．．．って、よ　　けいにややこしいけど、よくわからないときはサンプルをみてね。・引数　int sorttype: ソートの方法　　　　　　　　　　　SORT_BUBBLE: バブルソート法　　　　　　　　　　　SORT_SHELL : シェルソート法(速い) 　　　　int argtype : ソートする変数の型　　　　　　　　　　　SORT_CHAR : char(1Byte) 　　　　　　　　　　　SORT_SHORT : short(2Byte) 　　　　　　　　　　　SORT_LONG : long(4Byte) 　　　　　　　　　　　SORT_STR : 文字列　　　　void *data : ソートする配列のポインタ　　　　int n : 配列の要素数　　　　int *retlank: 順位を格納する(要素数 n の)配列・戻値　なし【補足　】Ｓ）　なぜソートの方法が二つあるのかって、疑問に思う人もいるでしょう。　　これは、オブジェクト指向のまねごとをしたかったのよ。実際は、速い　　シェルソートしか使わないんだけどね。　　　それとね、ソートする変数の型は、注意してね。ＧＣＣではｉｎｔ型　　は、４Ｂｙｔｅだけど、ＬＳＩ－Ｃとかは、２Ｂｙｔｅだからね。とい　　うことは、このプログラムは再コンパイルすれば、いろんなＣに使えるっ　　て事だね。ああ、なんて高い汎用性。Ｕ）　もう終わったかい、Ｓ。Ｓ）　もちろんよ。わかりやすくまとまったこの文章。ああっ、わたしって　　天才。Ｂ）　そうですね、もうひとつ注意すべきことは、この関数では実際にデー　　タに書き込まずに、別の配列に順位の番号を格納しているんですね。だ　　から実際にデータを並び変えたいときは、ユーザーが書き換えてくださ　　い。Ｕ）　まだまだ詰めが甘いわね、Ｓ。Ｓ）　うっ。わたしならそんなことサンプル見ればわかるもん。Ｂ）　そのサンプルを見ない人がいるかもしれないでしょう。Ｕ）　そういう事よ。まだまだそんなんじゃ、一人で解説は難しいようだね。Ｓ）　うっ。 Chapt.7 strin についてＵ）　さて、次は私が解説するよ。Ｓ、あんたはもう出番がないだろうから、　　自分の部屋に帰って寝たら。Ｓ）　なによ。まだわたしの出番はあるわよ。それにＵのフォローもあるし。Ｕ）　ほーっほほほ。何を言うかと思えば。わたしはＳにフォローされるほ　　どあまかないよ。だまって私の解説を聞いて、手本になさい。【機能　】グラフィック画面での文字列の入力をする。（１６色）【ソース】strin.c strindat.c 【ヘッダ】strin.h 【関数　】 ○ ST_locate( int x, int y ) Ｕ）　この関数では、文字列入力のグラフィックの左上の座標を指定してね。　　そのとき変な値をセットしたら、おしおきだよ。・引数　int x,y: 表示する左上の座標 ( 0 <= x <= 367, 0 <= y <= 433 ) ・戻値　0: 正常終了 1: 座標設定が適切でない ○ ST_inputStrings( char *egbwork, char *str, int n, const char *mes ) Ｕ）　この関数は、実際に文字列を入力してもらって、その文字列を得る関　　数だよ。ユーザーが[ESC][取消]などで入力を拒否するかもしれないから　　戻値をきちんとチェックして、それなりの対応をするんだよ。いいね。・引数 char *egbwork: EGB-BIOSワークエリアのポインタ char *str : 文字列を格納する配列のポインタ int n : 入力する文字列の最大サイズ char *mes : 表示するメッセージ・戻値　-3: [ESC][取消]による入力の拒否その他: 入力された文字列のサイズ。何も入力されないときは、0。【補足　】Ｕ）　どお、わたしの解説は。ためになったでしょ。Ｓ）　なによ。このプログラムはほとんど注意するところがないじゃない。Ｂ）　そうでもないですよ。文字列を格納する配列は十分な容量を確保し　　て、入力文字列の最大サイズがこの容量より小さくないと、バクの原　　因になりますよ。Ｕ）　さすが、Ｂ。よく気付いたね。ちょっとＳを試そうとして、わざと　　言わないで置いたんだけど、やっぱりＳは気付かなかったわね。Ｂ）　あと、これをリンクするとき一緒に symbol.o もリンクしてください。 Chapt.8 symbol についてＵ）　これとこの次の関数は、前回も応募したし、大きな変更もないから　　ほとんど説明することがないだろうからＢ、あんたに２つ任せるわ。Ｂ）　いいんですか、わたしが２つも解説してしまって。Ｓ）　お姉さまならいいわよ。Ｂ）　それじゃ、わたしが解説するわ。【機能　】グラフィック画面への文字列の出力をする。【ソース】symbol.c 【ヘッダ】symbol.h 【関数　】 ○ symbol( char *egbwork, int x, int y, char *str ) Ｂ）　EGB_putSjis関数にバグがあったので、この関数を作りました。・引数 char *egbwork: EGB-BIOSワークエリアのポインタ　　　　int x,y : 文字表示の基準線の左端の座標　　　　char *str : 表示する文字列・戻値　なし【補足　】Ｂ）　この関数は、他のオブジェクトでよく使われているから、このオブジェ　　クトは、よく一緒にリンクするするようになります。　　　あと、指定する座標に注意してくださいね。 Chapt.9 value についてＢ）　引き続きわたしが解説します。【機能　】文字列を計算して、倍精度実数型で出力する。【ソース】value.c 【ヘッダ】value.h 【関数　】 ○ calcvalue( const char *str, double *ans ) Ｂ）　この関数は、文字列に書いてある計算式を計算して、答えを倍精度実　　数型で出力します。計算式が間違ってて、計算できない場合もあるので　　注意してくださいね。・引数　char *str : 計算する文字列　　　　double *ans : 答えを格納する倍精度実数型の変数のポインタ・戻値　0 : 正常終了　　　　1 : 計算できない（文法上、計算上）【補足　】Ｂ）　この関数は、１０進数の他に、数字の初めが "0x" なら１６進数とし　　て計算してくれます。また数学的に計算できない式は、やめてください　　ね。例えば０で割るとか。 Chapt.10 vircon についてＵ）　さーて。最後の章は当然長女であるこの私がびっしっとしめるわよ。【機能　】グラフィック画面での printf 関数相当のことを実現する。【ソース】vircon.c 【ヘッダ】vircon.h 【関数　】 ○ VC_init( char *work, int bx, int by, int w, int l, int fc, int bc ) Ｕ）　まず初めにこの関数を実行して、いろんな設定をするんだよ。まあ、　　文字の色、背景色は後で変えられるけどね。これを実行した時に、画面　　も、書かれるよ。・引数　char *egbwork: EGB-BIOSワークエリアのポインタ　　　　int bx,by : 表示画面の左上　　　　int w : 表示の桁数(半角で) 　　　　int l : 表示の行数　　　　int fc : 表示の文字色　　　　int bc : 背景色・戻値　なし ○ VC_cls() Ｕ）　これは、コンソールのエリアをクリアする関数だよ。・引数　なし・戻値　なし ○ VC_setWriteColor( int fc ) Ｕ）　これは、文字を表示する色を設定する関数だよ。これにだけじゃなく　　て、全体に言えることなんだけど、エラーチェックが甘いから、各自で　　気をつけてね。・引数　int fc : 表示文字の色・戻値　なし ○ VC_setBackColor( int bc ) Ｕ）　これは、背景色を設定する関数ね。・引数　int bc : 背景色・戻値　なし ○ VC_locate( int x, int y ) Ｕ）　これは、現在のコンソールの書き込み位置をを設定する関数ね。・引数　int x,y: 表示画面内の現在位置の桁数と行数・戻値　なし ○ VC_printf( char *fmt, ... ) Ｕ）　これは、printf 関数のような働きをするんだけど、かなり低機能なん　　だ。%sと%dしか使えなくてしかもその桁数などの設定もできないんだ。　　それと引数がちょっと面倒で、先にその引数の型を示してから、目的の　　引数を渡すから、因数の数が、約２倍になっちゃうんだよ。・引数　char *fmt : 書式　　　　... : 書式で%s,%dが使われたときに必要な引数　　　　引数の型 : S_INT short int 　　　　　　　　　: US_INT unsigned short int 　　　　　　　　　: L_INT long int 　　　　　　　　　: UL_INT unsigned long int 　　　　　　　　　: CHAR char 　　　　　　　　　: POINTER char *（ポインタ）・戻値　なし【補足　】Ｕ）　ちょっと、各関数の説明をはしょっちゃってごめんね。ちょっとわた　　しも疲れてきたのよ。まあ、読んでるあんたの方が疲れてるかもしれな　　いけどね。　　　これも、リンクするときは、いっしょに symbol.o もリンクしてね。　　　それと注意点といえば、引数の型を正しく設定することぐらいかね。 Chapt.11 サンプルについてＢ）　作者がデバッグがてらにつくったサンプルプログラムも一緒に応募し　　ます。なにか参考になれば、幸いです。Ｓ）　なによ。自分でコンパイルしようとしたけど、うまくいかないわよ。Ｕ）　そんなあなたに。Ｕ姉さんのワンポイントアドバイス。まず、インク　　ルードファイルで、ＧＣＣにはないはずの<egb.h>などが書いてあるけど　　それは、作者が自分でライブラリのマニュアルを編集して作ったのよ。　　ＧＣＣでは、関数のプロトタイプ宣言がなくてもいいんだけど、引数の　　エラーチェックができなくなるから、自作したんだそうよ。これは、あ　　なたのほうで、その行を消すか、それに相当するヘッダファイルをつく　　るかしてね。　　　それと、リンクで失敗したときは、必要なファイルと一緒にリンクし　　ているかどうかチェックしてね。ソースファイルの始めに書かれている　　から。 Chapt.12 自作ソフトへの組み込みについてＵ）　応募したオブジェクトおよびそのソースは、使う前に私に向かって３　　回祈るのよ。Ｂ）　Ｕ、そうじゃないでしょ。Ｕ）　ちぇーっ。まあ、真面目な話、使用に関してはフリーです。ＧＣＣ以　　外のコンパイラで使える関数は、各自のコンパイラで再コンパイルして　　ご利用ください。そして、お決まりどおり、使用によっていかなること　　がおこっても、作者は責任を負いません。また、バクを修正する義務も　　持ちません。が、積極的にバグは退治していきたいので、報告して頂け　　ると嬉しいです。作者はＮＩＦＴＹに加入しているので、どうぞお気軽　　にメールをくださいな。Ｓ）　あら、Ｕにしては、ずいぶんと言葉が丁寧ね。バグでもあるのかしら。Ｕ）　あんた、そんなこと言ってると後でお仕置きよ。Ｓ）　えっ。わたしなにか言ったっけ。Ｕ）　逃げたわね。Ｂ）　それじゃ、この辺で、お別れですね。ご感想、ご意見、ご要望があり　　ましたら、富士通経由または、電子メールにて、御寄せ下さい。それが　　作者の喜びであり、プログラムをよりよいものにするために必要なので　　すから。それではまた逢う日まで、Ｕ・Ｂ・Ｓ）さようなら。